home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / dtype / cdt_39_10.lha / cdt / doc / c_dtc.doc next >
Text File  |  1995-06-04  |  4KB  |  89 lines
  1.  
  2.  
  3. TABLE OF CONTENTS
  4.  
  5. c.datatype/c.datatype
  6.  
  7.  
  8. c.datatype/c.datatype                                    c.datatype/c.datatype
  9.  
  10.     NAME
  11.         c.datatype - data type for any c source
  12.  
  13.     FUNCTION
  14.         This datatype is designed to display C and C++ source codes. It
  15.         display's different parts of the C source in different style and
  16.         color.At the moment these parts are :
  17.            STANDARD - any text which, doesn't match the following parts
  18.            COMMENT  - any comment such like /* ... */ and // ...
  19.            CPP      - any C-PreProcessor keyword like "#define" or "#include"
  20.            KEYWORD  - any C/C++ keyword, which isn't handled explicitly
  21.            STORAGE  - extern,static,register,auto keywords
  22.            TYPES    - basic type keywords like int,char,long etc.
  23.            TYPENAME - any name following a struct,union,class or enum
  24.            STRING   - any string or char literal
  25.            NUMBER   - any number constant decimal,hex
  26.  
  27.         It uses a parser generated by bison with my yacc grammer.Because it's
  28.         a parser, it may occur a parse error on some unusual source code. If
  29.         this happens please send me a description of this parse error and
  30.         maybe the input file. So I can fix this problem !
  31.  
  32.     PREFS
  33.         The c.prefs file is searched first in PROGDIR:Prefs/DataTypes/ and
  34.         then in Env:DataTypes/ with the following three ReadArgs() templates
  35.         :
  36.  
  37.         - CPART/A/K,PEN/N/K,R=RED/N/K,G=GREEN/N/K,B=BLUE/N/K,ITALIC/S,BOLD/S,
  38.           UNDERLINED/S,TEXT/S
  39.  
  40.           CPART is one of the explaned cpart names like COMMENT or CPP.
  41.           PEN assigns the color with the pen number to the specified part
  42.           R,G,B defines a new color for the specified part. This color is
  43.                 allocated with ObtainBestPenA(...,OBP_Precision,
  44.                                                   PRECISION_ICON);
  45.           ITALIC,BOLD,UNDERLINED specifies the font style for the part
  46.           TEXT treat this CPART as normal text
  47.  
  48.         - GLOBAL/A/S,TABLENGTH/N/K,NONESTEDCOMMENTS/S
  49.  
  50.           GLOBAL indicates, that this line is a global setting. Note: The
  51.               /A/S combination isn't supported from ReadArgs(), so I check
  52.               it manually !
  53.           TABLENGTH - number of spaces to use for a tab !
  54.           NONESTEDCOMMENTS - disables nested comments
  55.  
  56.         - INLINEARGS/A/S,KEYWORD/K/A,PATTERN/K/A,LINES/N/K
  57.  
  58.           INLINEARGS indicates ,that this line is a inline args setting
  59.           KEYWORD defines the keyword to search for the inlined arguments for
  60.               the first lines. You can specify any string, which is compared
  61.               using strcmp(). After the keyword follows directly the pattern
  62.               specified by PATTERN.
  63.           PATTERN defines the pattern to get the inlined arguments. Any char
  64.               in the pattern must match the char in the text after the
  65.               keyword. To get any arguments you can specify a template using
  66.               the '%' char like in scanf() function. Following options are
  67.               supported :
  68.                   %t - stands for the TABLENGTH
  69.                   %c - stands for NESTEDCOMMENTS or NONESTEDCOMMENTS
  70.           LINES - specifies the number of lines from the beginning scanned
  71.               for inline arguments. Default is 10.
  72.  
  73.         - USERTYPES/A/S,TYPES/M
  74.  
  75.           USERTYPES indicates, that this line contains user defined types
  76.  
  77.           TYPES defines words to treat as basic types like int or long etc.
  78.  
  79.     AUTHOR
  80.         Stefan Ruppert
  81.         Windthorststrasse 5
  82.         65439 Floersheim am Main
  83.         Germany
  84.         EMail: ruppert@vs3.informatik.fh-wiesbaden.de
  85.  
  86.     SEE ALSO
  87.         text.datatype
  88.  
  89.